home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / GENELOGY / PEDIGREE.LZH / PEDIGREE.DOC < prev    next >
Text File  |  1989-04-15  |  44KB  |  1,453 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                           /- PEDIGREE
  20.                               PEDIGREE ---|
  21.                                           \- PEDIGREE
  22.  
  23.  
  24.  
  25.                                    Version 1.02
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.         (C) 1988-1989 By Charles H. Orange
  44.                          702 Maple Avenue
  45.                          Downers Grove, Ill. 60515
  46.                          (312)964-8898
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                   INTRODUCTION
  74.  
  75.  
  76.         PEDIGREE is a program to keep track of dog pedigrees and American
  77.         Kennel Club Titles.  The original intent for writing this program
  78.         was to keep track of pedigree data for our own line of dogs only.
  79.         I soon expanded it to maintain show title information and
  80.         enlarged my data file to include as many animals as possible in
  81.         our breeds.  I wrote the program to be flexible enough to allow
  82.         historical data from old books, foreign pedigrees and show
  83.         catalogs to be used as well as the American Kennel Club Stud Book
  84.         and American Kennel Club Awards periodicals.  Provision has been
  85.         made for the inclusion of Register of Merit and Working Terrier
  86.         Trial Certificate of Gameness awards even though these are not
  87.         A.K.C. recognized awards.
  88.  
  89.         I am releasing this program for distribution as user supported
  90.         software subject to the license agreement at the end of this
  91.         manual.  The non-registered version of the program will only
  92.         support 300 animal records.  There is a registration form and
  93.         copy of the license agreement as a separate file on the
  94.         distribution disk.  The registered version of the program will
  95.         support over 2 million animal records.  I welcome all comments,
  96.         suggestions for improvements and reports of bugs from registered
  97.         users.  I will try to incorporate as many improvements as
  98.         possible in future releases.
  99.  
  100.         This program is not in the public domain and is not distributed
  101.         as free software.  You may use this product on a trial basis only
  102.         for the purpose of determining it's suitability to your needs.
  103.         If you wish to continue using the product on a regular basis, you
  104.         must register by sending $40.00 to the address listed below.
  105.         Registered users will receive announcements of future upgrades
  106.         and additional products as available.
  107.  
  108.                            Thank you for your support!
  109.  
  110.  
  111.                   Charles H. Orange
  112.                   702 Maple Avenue
  113.                   Downers Grove, Ill. 60515
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 1
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                     OVERVIEW
  140.  
  141.  
  142.         PEDIGREE is a program to aid in the keeping of dog pedigree and
  143.         title records.  It is divided into two basic parts, one to add or
  144.         change records, and one to create pedigrees and other useful
  145.         reports.  A complete description of each process is given in
  146.         following chapters.
  147.  
  148.         Reports generated include three to seven generation pedigrees,
  149.         seven generation line breeding lists, lines of descendancy and
  150.         top producing sire and dam lists.
  151.  
  152.         Data may be input from any number of sources.  The complete
  153.         selection of A.K.C. awards may be entered as well as data from
  154.         other sources.  As new data is entered, it is checked against any
  155.         data in the system.  Any discrepancies which are found will
  156.         display an error message and the new data will not replace the
  157.         data already in the system.
  158.  
  159.         PEDIGREE is menu driven with a single letter required to move to
  160.         an item on a menu.  This may be a function of the program, or
  161.         another menu of choices.  To exit to the previous menu, press the
  162.         <ESCAPE> key.
  163.  
  164.         Help topics are available at all menus and at all places where
  165.         input is required from the keyboard.  Help is available by
  166.         pressing the function key <F1>.
  167.  
  168.         The files used in the PEDIGREE program are shown below identified
  169.         by function.
  170.  
  171.             The program files are as follows:
  172.                   PEDIGREE.EXE     the pedigree program itself.
  173.                   PEDIGREE.HLF     the help file.
  174.                   PEDIGREE.DOC     this document file.
  175.                   PEDIGREE.LIC     the license agreement and order form.
  176.                   INSTALL.BAT      installs PEDIGREE on a hard disk.
  177.                   INSTALLH.BAT     part of the hard disk installation.
  178.  
  179.             The data files are created as follows:
  180.                   Breed.PE1        the main data base file.
  181.                   Breed.PE2        the name index file.
  182.                   Breed.PE3        the sire index file.
  183.                   Breed.PE4        the dam index file.
  184.                   Breed.PE5        the alias name file.
  185.                   Breed.PE6        the alias index file.
  186.                   Breed.PE7        the foreign title file.
  187.                   Breed.PE8        the foreign title index file.
  188.  
  189.                   Breed.TXT        text file output for other programs.
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 2
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                                SYSTEM REQUIREMENTS
  206.  
  207.  
  208.              Computer: IBM PC or compatible.  A hard disk is preferred as
  209.                         the data files require approximately 150 bytes
  210.                         per animal.  A data file of fewer than 1500
  211.                         animals would fill a 360k floppy disk on a single
  212.                         floppy system.  A two floppy system will be able
  213.                         to support a data file of approximately 2500
  214.                         animals.
  215.  
  216.              Printer:   Any printer should work.  A printer which
  217.                         supports the IBM extended character set will be
  218.                         able to print pedigrees with lines connecting
  219.                         related animals.  In order to print out a listing
  220.                         of the complete data file, a printer capable of
  221.                         printing 160 characters on a line is required.
  222.                         Printer definition codes may be entered the first
  223.                         time the program is run.  The default settings
  224.                         are for Epson printers.
  225.  
  226.              Monitor:   Any monitor which supports IBM monochrome
  227.                         displays may be used.  Color is not required for
  228.                         the program to operate.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 3
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.                                  GETTING STARTED
  272.  
  273.  
  274.         The first step to running PEDIGREE is to make a back-up copy of
  275.         the disk.  Consult your DOS manual for any details of the copy
  276.         process that you are not sure about.  Take your original disk and
  277.         put it away in a save place.
  278.  
  279.         The steps below which refer to installing PEDIGREE on a hard disk
  280.         may be completed automatically by placing your copy of the disk
  281.         in Drive A and typing A:INSTALL c <RETURN> where c is the letter
  282.         of the hard disk drive where PEDIGREE is to be installed.  Now
  283.         skip to the section on changing the file named CONFIG.SYS.
  284.  
  285.         If you are using a computer without a hard disk, copy the files
  286.         PEDIGREE.EXE and PEDIGREE.HLF onto a separate floppy disk.  This
  287.         will become your working disk.  If you only have one floppy disk
  288.         drive, it is advisable to delete the file PEDIGREE.HLF from the
  289.         working disk only to conserve space for data files.  You will
  290.         then have to refer to this manual in place of using the help
  291.         screens from within the program.
  292.  
  293.         If you are using a computer with a hard disk, create a directory
  294.         on that disk named \PEDIGREE.  The pedigree program and the help
  295.         file should be located in the same directory.  Copy the files
  296.         PEDIGREE.EXE and PEDIGREE.HLF from the distribution disk into the
  297.         directory which you just created.  The batch file INSTALL.BAT
  298.         will do this for you if you want.  Run this file by changing the
  299.         default drive to your floppy disk and typing 'INSTALL d' where
  300.         'd' is the drive letter of your hard disk.
  301.  
  302.         Change the file CONFIG.SYS on your boot disk to include the
  303.         following lines:
  304.  
  305.                   buffers=30
  306.                   files=20
  307.  
  308.         If no CONFIG.SYS file exists on your boot disk, then consult your
  309.         DOS manual about creating text files using the COPY command from
  310.         the keyboard.
  311.  
  312.         For advanced DOS users, with DOS version 3.0 or greater, the
  313.         PEDIGREE.EXE file may be either in the current directory or in
  314.         the DOS Path.  The PEDIGREE.HLF file may be either in the current
  315.         directory or in a directory identified by the environment
  316.         variable 'SET PEDIGREE=path' where path is any valid directory
  317.         path.
  318.                   Ex:   SET PEDIGREE=D:\HELPFLS
  319.         The last '\' is optional and does not need to be on the path.
  320.  
  321.         Change drives and directories to the one which contain your
  322.         working copies of PEDIGREE.EXE and PEDIGREE.HLF or to the
  323.         directory where you want the breed data files stored.  You are
  324.         now ready to run the program.
  325.  
  326.  
  327.  
  328.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 4
  329.  
  330.  
  331.  
  332.  
  333.  
  334.         Start PEDIGREE by typing PEDIGREE <RETURN>.  After you have read
  335.         the introductory screen, press any key for the prompt for breed
  336.         name.  The breed name will become the name of the files created
  337.         by the computer.  Acceptable names are from 1 to 8 characters
  338.         long.  If the breed name entered is found on the disk, the
  339.         existing files are opened.  If the name is not found,
  340.         confirmation is required before new data files are created.
  341.         Alternatively, you may enter the breed name on the command line
  342.         after the word PEDIGREE.
  343.  
  344.         If this is the first time that you are using this breed, a
  345.         message will state that no data base exists and prompt for
  346.         creation of a new one.
  347.  
  348.         The main menu will now appear.  The functions will be described
  349.         in the remaining sections of this manual except for the Exit
  350.         function which simply closes all files and ends the program.
  351.         Always exit the program before turning off your computer as
  352.         valuable data may be lost otherwise.
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 5
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.                               CONVENTIONS FOR INPUT
  404.  
  405.  
  406.         Where inputs are required, they take the following formats:
  407.  
  408.  
  409.         ANIMAL REGISTERED NAME
  410.         The registered name of the animal in question.  Do not include
  411.         any Championship or Obedience Titles.  Length is limited to 35
  412.         characters including spaces and punctuation.
  413.  
  414.  
  415.         ANIMAL SEX
  416.         For dogs use 'M' or 'D'.         For bitches use 'F' or 'B'.
  417.  
  418.         Either upper case or lower case may be used.  Follow with a
  419.         <RETURN>.  If sex is not known, use only a <RETURN>.  Any other
  420.         letter will be ignored.
  421.  
  422.  
  423.         AKC NUMBER
  424.         The AKC number is input with a two letter prefix followed by a 6
  425.         digit number.  Either upper case or lower case may be used.  If
  426.         there is only one letter in the prefix, use a '-' in place of the
  427.         second letter.
  428.  
  429.  
  430.         BIRTH DATE
  431.         The month, day and year inputs should be in the format of a one
  432.         or two digit month followed by any of '/', '-', '.', or space
  433.         followed by a one or two digit day followed any of '/', '-', '.',
  434.         or space followed by the year.  The year may be two or four
  435.         digits.  If only two digits, the year is assumed to be in the
  436.         20th century (i.e. 88 becomes 1988).
  437.  
  438.             The following are all acceptable examples:
  439.               05/03/87     5/3/1987     5-03-87     05,03,1987     5 3 87
  440.  
  441.  
  442.         PUBLISHED DATE
  443.         The month and year inputs should be in the format of a one or two
  444.         digit month followed by any of '/', '-', '.', or space followed
  445.         by the year.  The year may be two or four digits.  If only two
  446.         digits, the year is assumed to be in the 20th century (i.e. 87
  447.         becomes 1987).  If the month is not known, enter 00/87 for any
  448.         time in 1987.  If a title is known to exist but no date is known,
  449.         enter y or yes.
  450.  
  451.             The following are all acceptable examples:
  452.               05/87    5/87    05/1987    5-87    5,87    5 87    05 1987
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 6
  461.  
  462.  
  463.  
  464.  
  465.  
  466.         DATA RELIABILITY
  467.         The number for data reliability is a number between 0 and 255.
  468.         The higher the reliability of the source of data, the lower the
  469.         number should be.  Any data input from an official AKC
  470.         publication automatically has a reliability number of 0.  The
  471.         entries created for sires or dams will start out with a
  472.         reliability of 255.  Numbers in between should be used for other
  473.         data sources.  Consistency should be maintained to keep track of
  474.         data sources.  This should enable back-tracking in the event of
  475.         conflicting data from different sources.
  476.  
  477.  
  478.         COUNTRY NAMES
  479.         The input of an abbreviation for a country name is required.
  480.         Suggested abbreviations are listed.
  481.  
  482.  
  483.         NUMBER INPUT
  484.         The input of a whole number is required.  Digits 1 through 9 and
  485.         0 are the only acceptable input keys.  A <RETURN> is required to
  486.         end the input.  An error message will be displayed on the bottom
  487.         screen line if the entry is not within the acceptable range.
  488.  
  489.  
  490.         KEYBOARD ENTRY EDITING
  491.  
  492.         During keyboard entry, the following edit keys are available:
  493.  
  494.         Ctrl-H, Ctrl-S, Delete, Back Space - will delete the previous
  495.         character.
  496.  
  497.         Ctrl-A, Ctrl-X - will delete all previous characters to start of
  498.         entry.
  499.  
  500.         Ctrl-D - will copy the next character.
  501.  
  502.         Ctrl-F, Ctrl-R - will copy through the end of the entry.
  503.  
  504.         Ctrl-P - will allow the insertion of a control character into the
  505.         information.  This is only used in creating the printer set-up
  506.         strings.
  507.  
  508.         <Escape> - will abort the entry without making any changes.
  509.  
  510.         <Return> - will accept the entry as it is displayed.
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 7
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.                                ADD or REVISE DATA
  536.  
  537.  
  538.         Selecting ADD or REVISE DATA will bring up another menu showing
  539.         choices for adding, revising or deleting records from the main
  540.         data base; as well as choices for adding or deleting foreign
  541.         champion data and alias names.  Two selections for reorganizing
  542.         the data base and creating sequential file output are described
  543.         in detail in the section on Data File Management.
  544.  
  545.  
  546.                   Add New Entries To Database:
  547.  
  548.         The selection of Add New Entries will display a list of possible
  549.         sources for new data.  If the animal is found in the data file
  550.         then only blank fields  will be available for input.  When inputs
  551.         are from A.K.C. publications, the date of the publication will be
  552.         required before the animal entry screen is displayed and only
  553.         fields which are in the A.K.C. publication will be available for
  554.         input.
  555.  
  556.         Inputs may come from the following sources:
  557.  
  558.                   From AKC Stud Book
  559.                   Championships From AKC Gazette
  560.                   CD Titles From AKC Gazette
  561.                   CDX Titles From AKC Gazette
  562.                   UD Titles From AKC Gazette
  563.                   TD Titles From AKC Gazette
  564.                   TDX Titles From AKC Gazette
  565.                   OTCH Titles From AKC Gazette
  566.                   AFC Titles From AKC Gazette
  567.                   FC Titles From AKC Gazette
  568.                   JH Titles From AKC Gazette
  569.                   SH Titles From AKC Gazette
  570.                   MH Titles From AKC Gazette
  571.                   Data From Other Sources
  572.  
  573.         Data From Other Sources includes such items as Register of Merit
  574.         and Working Terrier Certificates of Gameness as well as data from
  575.         pedigrees and other publications.  All data fields are available
  576.         for input.  The data reliability entry should reflect the
  577.         confidence for the source of data.  A lower number for
  578.         reliability indicates a lower chance of bad data.  If the animal
  579.         is found in the data file, then only blank fields will be
  580.         available for input.
  581.  
  582.         This is a second chance to ignore data which has just been
  583.         entered.  If there are any errors in data added, pressing the
  584.         letter 'E' will erase the screen and start over.  Any other key
  585.         will accept the input data as it is shown.
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 8
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                   Revise An Entry:
  599.  
  600.         The selection of Revise an Entry will request an animal name for
  601.         data revision.  All fields of data may be revised.  Care should
  602.         be taken for it is possible to revise not only an animal's name,
  603.         but to change the names of the animal's sire and dam.
  604.  
  605.  
  606.                   Delete An Entry:
  607.  
  608.         The selection of Delete an Entry will allow an entry to be
  609.         removed from the data file or exchanged for another if duplicate
  610.         entries have been made with mis-spellings of name.  Confirmation
  611.         will be requested before any action is taken.
  612.  
  613.  
  614.                   Enter Foreign Champion Data:
  615.  
  616.         Foreign Champion Entries may be entered with an abbreviation for
  617.         the country.  This will allow limited record keeping of animals
  618.         with foreign titles.
  619.  
  620.         Foreign Champion Entries made by mistake may be removed from the
  621.         data file.  The country should be entered with the same
  622.         abbreviation used when the entry was made.
  623.  
  624.  
  625.                   Enter Alias Name Data:
  626.  
  627.         The selection of Enter Alias name data will allow a second name
  628.         to be entered or deleted for an animal.  This is useful in the
  629.         case of an imported animal which has a different registered name
  630.         in another country.  The entry in the data file should be the
  631.         name by which the animal is registered with the A.K.C. while the
  632.         alternate name or names used are added here.
  633.  
  634.  
  635.                   Reorganize Datafile:
  636.  
  637.         The selection of Reorganize the Datafile will be useful if some
  638.         of the index files have been damaged by a power failure or
  639.         through some equipment fault.  This may be avoided by keeping
  640.         regular back up disks of data files.
  641.  
  642.  
  643.                   Sequential File Processing:
  644.  
  645.         Sequential File Processing will only be used to import or export
  646.         data for other programs.  At the present time, no other programs
  647.         have been written to take advantage of this feature.
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 9
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.                                 GENERATE REPORTS
  668.  
  669.  
  670.         The selection of Generate Reports will allow the making of
  671.         pedigrees and other useful information for breeding selection.
  672.         The entire data file and an alphabetical list of registered names
  673.         may also be printed.  The following is a descriptive list of the
  674.         available reports:
  675.  
  676.  
  677.                   Create Pedigree:
  678.  
  679.         A 3 generation pedigree may be displayed on the screen, or a
  680.         pedigree with between 3 and 7 generations may be printed.  A menu
  681.         with the selection of these options will appear.
  682.  
  683.         A pedigree with a blank line for later filling in of the animal's
  684.         name can be made by using an asterisk (*) in place of the name.
  685.         This allows for creating a pedigree for an as yet un-registered
  686.         puppy.  Proposed breedings can be seen by filling in a fictitious
  687.         name and then answering the requests for sire and dam.
  688.  
  689.         Three and four generation pedigrees will be printed on the top
  690.         half of a sheet of paper.  Five generation pedigrees will fill an
  691.         entire sheet.  Six and seven generation pedigrees will spill over
  692.         onto the next sheet and will probably not be very neat nor easy
  693.         to read.
  694.  
  695.  
  696.                   Line Breeding List:
  697.  
  698.         A line breeding list is a listing of all of the ancestors in the
  699.         previous 7 generations.  Each animal is listed only one time with
  700.         a key to the generations and frequencies of appearance in the
  701.         pedigree.  A line breeding list may be printed sorted either by
  702.         genetic weight of the ancestors or by frequency of appearance in
  703.         the background.  The line breeding list shows the generations in
  704.         which an animal appears with the sire's side on the left and the
  705.         dam's side on the right of a decimal point.  The percentage of
  706.         genetic contribution which an animal provides in all generations
  707.         is listed.  The number of ancestors missing from the database is
  708.         printed.
  709.  
  710.         With 7 generations, the total genetic contribution of each
  711.         generation must total 100%.  Because of this, the total for all 7
  712.         generations will add up to 700%.  This will explain why an animal
  713.         may possibly contribute more than 50% of the genetic background
  714.         through appearance in more than one generation.
  715.  
  716.  
  717.                   Top Producing List:
  718.  
  719.         A list of sires or dams with the highest number of Champion
  720.         offspring may be produced.  The minimum number of Champion
  721.         offspring for inclusion on the list must be specified.  The list
  722.  
  723.  
  724.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 10
  725.  
  726.  
  727.  
  728.  
  729.  
  730.         will be sorted from highest to lowest number of Champions
  731.         produced.  The number in parenthesis is the number of Champion
  732.         offspring.  The listing for each offspring contains the animal's
  733.         sex and the issue date of the AKC Gazette which published the
  734.         Championship.  The offspring are listed in order of birth date.
  735.  
  736.  
  737.                   Descendant List:
  738.  
  739.         A list of descendants from an animal may be produced.  The list
  740.         can either include all descendants or only continuous
  741.         Championship lines of descendancy.  The generation appears in
  742.         parenthesis before each animal's name.  The sex of each animal
  743.         appears at the right of the line.  If the list was requested to
  744.         only contain continuous Championship lines, the issue date of the
  745.         AKC Gazette which published the Championship is also on the right
  746.         of the entry.
  747.  
  748.  
  749.                   List Datafile:
  750.  
  751.         The contents of the data file may be printed in sequential
  752.         format.  The starting entry number and the ending entry number
  753.         may be input to print a portion of the data file.  The printing
  754.         will start with the beginning of the page which contains the
  755.         starting entry number.  Accept the default starting number and
  756.         ending number to print the entire data file.
  757.  
  758.  
  759.                   List Names In Alphabetical Order:
  760.  
  761.         An alphabetical index of animals in the data file may be printed.
  762.         This list contains a cross-reference number to the entry in the
  763.         complete data file.  The printing may be started with any page,
  764.         and may end with any page.  Accept the default starting number
  765.         and ending number to print the entire alphabetical index.
  766.  
  767.         The format will be as follows (except in 3 columns):
  768.  
  769.             1701 $ Animal Name A               300 # Animal Name C
  770.               31 * Animal Name B              5122   Animal Name D
  771.  
  772.         The symbols between the number and the name indicate the
  773.         following:
  774.  
  775.             $  Birth date and Sex of animal are known
  776.             #  Sire and Dam of animal are known
  777.             *  Sire, Dam, Birth date, and Sex of animal are known
  778.  
  779.  
  780.  
  781.                   Statistical Summary:
  782.  
  783.         This selection will count the entries in the data file and report
  784.         on the number of animals in each category.
  785.  
  786.  
  787.  
  788.  
  789.  
  790.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 11
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                   Re-direct Printer Output:
  797.  
  798.         This selection will re-direct output between the printer and a
  799.         text file on the disk.  The text file will contain all data which
  800.         would normally be sent to the printer except for printer control
  801.         commands.  This is a plain ASCII text file suitable for inclusion
  802.         into word processor files or other programs.  The text file will
  803.         have the name 'Breed.TXT' and will be appended to every time the
  804.         output is re-directed to the file.  The output may be switched
  805.         between printer and text file as often as desired.  Output will
  806.         be sent to the printer at the start of the program.
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 12
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.                             SETUP PROGRAM INFORMATION
  866.  
  867.  
  868.         The selection of Setup Program Information will allow you to
  869.         setup the control codes required for your printer and unlock your
  870.         registered version of PEDIGREE.
  871.  
  872.  
  873.                   Printer Setup
  874.  
  875.         To set up your printer for proper operation of PEDIGREE, you will
  876.         need to refer to the printer operator's manual or programmer's
  877.         guide.  You will need to determine the correct codes necessary to
  878.         configure the printer to perform and to cancel the following
  879.         operations:
  880.  
  881.                   12 character per inch printing
  882.                   8 lines per inch printing
  883.                   160 characters per line
  884.                   letter quality printing
  885.                   enhanced or bold type
  886.  
  887.         If your printer is not capable of supporting any of these, the
  888.         program will still run, but the output will not be as neat as it
  889.         could be.
  890.  
  891.         The program initially configures the printer as using the Epson
  892.         character set for printer controls.  The first time the program
  893.         is run, the printer configuration process should be done.
  894.         Answering all prompts with a carriage return will accept these
  895.         Epson style control codes.  If you know what the proper codes for
  896.         your printer are then enter them.  At any time the printer may be
  897.         set up again through the main menu function D.
  898.  
  899.         The following sequence is used in defining a printer:
  900.  
  901.  
  902.                   Maximum Line Length:
  903.  
  904.         For printing the entire contents of the data base and the
  905.         contents of the alphabetical index to the data base, the line
  906.         length of the printer must be at least 160 characters.  If the
  907.         printer is not capable of printing 160 characters on one line
  908.         then these two report formats will not be available.  The
  909.         questions about condensed print mode are asked only if the
  910.         printer is capable of printing 160 characters per line.
  911.  
  912.  
  913.                   IBM Character Set Compatability:
  914.  
  915.         For printing pedigrees with a graphic tree structure, a printer
  916.         with the IBM Extended Character set is required.  If the printer
  917.         is not capable of this then pedigrees will be printed without a
  918.         line tree.
  919.  
  920.  
  921.  
  922.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 13
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                   Set Condensed Print Mode:
  929.  
  930.         Some printers are capable of using a wide sheet of paper to print
  931.         lines of 160 characters.  If this printer is like this, the
  932.         current input line should be cleared with a Ctrl-A or Ctrl-X
  933.         followed by a <RETURN>.  Other printers will require a sequence
  934.         of characters to set a condensed print mode.
  935.                   Reset From Condensed Print Mode:
  936.  
  937.         If printer codes were not used to set condensed mode then the
  938.         current input line should be cleared with a Ctrl-A or Ctrl-X
  939.         followed by a <RETURN>.  Other printers will require a sequence
  940.         of characters to reset from condensed print mode.
  941.  
  942.  
  943.                   Set Lines Per Page:
  944.  
  945.         When the printer is set up for wide sheets of paper, the number
  946.         of lines per page may not be the standard 66.  In this case,
  947.         enter the actual number of lines on the page.
  948.  
  949.  
  950.                   Set 12 Characters Per Inch:
  951.  
  952.         Pedigrees are printed at 12 characters per inch if possible.  If
  953.         this printer is not capable of printing at 12 characters per
  954.         inch, the current input line should be cleared with a Ctrl-A or
  955.         Ctrl-X followed by a <RETURN>.  Other printers will require a
  956.         sequence of characters to set the pitch.
  957.  
  958.  
  959.                   Reset From 12 Characters Per Inch:
  960.  
  961.         If printer codes were not used to set 12 characters per inch then
  962.         the current input line should be cleared with a Ctrl-A or Ctrl-X
  963.         followed by a <RETURN>.  Other printers will require a sequence
  964.         of characters to reset the pitch to standard 10 characters per
  965.         inch.
  966.  
  967.  
  968.                   Set 8 Lines Per Inch:
  969.  
  970.         Pedigrees are printed at 8 lines per inch if possible.  If this
  971.         printer is not capable of printing at 12 characters per inch, the
  972.         current input line should be cleared with a Ctrl-A or Ctrl-X
  973.         followed by a <RETURN>.  Other printers will require a sequence
  974.         of characters to set the line spacing.
  975.  
  976.  
  977.                   Reset From 8 Lines Per Inch:
  978.  
  979.         If printer codes were not used to set 8 lines per inch then the
  980.         current input line should be cleared with a Ctrl-A or Ctrl-X
  981.         followed by a <RETURN>.  Other printers will require a sequence
  982.         of characters to reset the line spacing to the standard 6 lines
  983.         per inch.
  984.                   Set Letter Quality Mode:
  985.  
  986.  
  987.  
  988.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 14
  989.  
  990.  
  991.  
  992.  
  993.  
  994.         Some reports are printed in letter quality mode if possible.  If
  995.         this printer is not capable of switching to letter quality, or is
  996.         only a letter quality printer, the current input line should be
  997.         cleared with a Ctrl-A or Ctrl-X followed by a <RETURN>.  Other
  998.         printers will require a sequence of characters to set letter
  999.         quality mode.
  1000.  
  1001.                   Reset From Letter Quality Mode:
  1002.  
  1003.         If printer codes were not used to set letter quality mode then
  1004.         the current input line should be cleared with a Ctrl-A or Ctrl-X
  1005.         followed by a <RETURN>.  Other printers will require a sequence
  1006.         of characters to reset from letter quality mode.
  1007.  
  1008.  
  1009.                   Set Enhanced Character Mode:
  1010.  
  1011.         Some reports are printed with enhanced characters if possible.
  1012.         If this printer is not capable of enhanced printing, the current
  1013.         input line should be cleared with a Ctrl-A or Ctrl-X followed by
  1014.         a <RETURN>.  Other printers will require a sequence of characters
  1015.         to set letter quality mode.
  1016.  
  1017.  
  1018.                   Reset From Enhanced Character Mode:
  1019.  
  1020.         If printer codes were not used to set enhanced character mode
  1021.         then the current input line should be cleared with a Ctrl-A or
  1022.         Ctrl-X followed by a <RETURN>.  Other printers will require a
  1023.         sequence of characters to reset from letter quality mode.
  1024.  
  1025.  
  1026.         This is the end of the settings for the printer.  For support of
  1027.         more than one printer, after the first printer is defined, exit
  1028.         the program and rename the file PEDIGREE.PRT to another name and
  1029.         then re-run the program to define the alternate printer.  Only
  1030.         the definitions in the file PEDIGREE.PRT will be used.
  1031.  
  1032.  
  1033.  
  1034.                   Install License Registration
  1035.  
  1036.         The selection of Install License Registration will allow
  1037.         registered users to unlock PEDIGREE to accept over 2 million
  1038.         animal records.  Prompts will be asked for the name of the
  1039.         license owner, the license number and the 16 character key code
  1040.         which is included with the license.  Keep the written record of
  1041.         these three items safe, as they will unlock all future upgrades
  1042.         to PEDIGREE as they are released.
  1043.  
  1044.         Enter the Name of the license owner as shown on the registration
  1045.         form.
  1046.  
  1047.         Enter the License Number from the registration form.
  1048.  
  1049.         Enter the Key Code from the registration form.
  1050.  
  1051.         An incorrect entry will display an error message and then return
  1052.  
  1053.  
  1054.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 15
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.         to the previous menu.  Simply try again and double check each
  1061.         line before going on to the next entry.
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 16
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.                                  ERROR HANDLING
  1130.  
  1131.  
  1132.         When an error occurs either in data file handling, or in keyboard
  1133.         data entry, a message is displayed on the bottom line of the
  1134.         screen.  The message will be cleared and the program will
  1135.         continue after pressing any key.  If the error is severe enough
  1136.         to cause the program to fail, all files will be closed and data
  1137.         saved where possible.  The importance of keeping back up data
  1138.         files cannot be over-emphasized.
  1139.  
  1140.         Non fatal errors will have no effect on the data files and are
  1141.         summarized below:
  1142.  
  1143.  
  1144.                   Entry Out Of Numerical Range:
  1145.  
  1146.         The number entered was not within the range allowable.  Re-enter
  1147.         a different number within the correct range.
  1148.  
  1149.  
  1150.                   Record Was Previously Deleted:
  1151.  
  1152.         This entry has already been deleted from the data file.  Re-enter
  1153.         a different animal name.
  1154.  
  1155.  
  1156.                   Conflicting Record Data:
  1157.  
  1158.         These two records have conflicting data.  The error codes are
  1159.         summed up to the number shown:
  1160.  
  1161.           128 = Differing Names              64 = Differing AKC Numbers
  1162.            32 = Differing Sex                16 = Differing Birth Dates
  1163.             8 = Differing Sires               4 = Differing Dams
  1164.             2 = Differing Stud Book Dates     1 = Differing Title Dates
  1165.  
  1166.         Example:  Error of 37  = 32 + 4 + 1  means records are different
  1167.                   in SEX  and DAM NAMES and TITLE DATES.
  1168.  
  1169.  
  1170.                   Animal Is Not In Data Base:
  1171.  
  1172.         Foreign championship data and alias names may not be entered for
  1173.         an animal which has not yet been added to the data file.
  1174.         Revisions may not be made without first adding the animal to the
  1175.         data file.
  1176.  
  1177.  
  1178.                   Name Is Already In Alias File:
  1179.  
  1180.         The alias name has already been entered into the file.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 17
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.                   Name Is Already In Data File - Delete First:
  1193.  
  1194.         The name being added as an alias or as a revised name to an
  1195.         existing entry already exists in the data file.  If this entry is
  1196.         correct, then the existing animal must be deleted from the data
  1197.         base first.
  1198.  
  1199.  
  1200.                   Alias Is Not In Data File:
  1201.  
  1202.         The alias name being deleted is not in the alias file.
  1203.  
  1204.  
  1205.                   Published Data Does Not Agree With Data File:
  1206.  
  1207.         The date of the Stud Book or AKC Gazette does not agree with
  1208.         existing data in the file for this animal.
  1209.  
  1210.  
  1211.                   Animal Is Not Of This Sex:
  1212.  
  1213.         The animal being entered as a Sire or Dam is already in the data
  1214.         file and has the wrong sex to be used in this situation.  This
  1215.         must be corrected by re-entering a different animal name.
  1216.  
  1217.  
  1218.                   Animal Is Of Opposite Sex For Offspring Listed:
  1219.  
  1220.         The animal has offspring in the data file which show this animal
  1221.         as being of the opposite sex.  The entry will have to be deleted
  1222.         and then be re-entered to change the sex, or the offspring will
  1223.         have to be changed.
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 18
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.                               DATA FILE MANAGEMENT
  1262.  
  1263.  
  1264.                   File Re-indexing:
  1265.  
  1266.         Reorganization of the data base may become necessary if index
  1267.         files have been corrupted through power outages or computer
  1268.         errors.  As these errors can occur at any time, it is very
  1269.         strongly recommended that you keep back up copies of all data
  1270.         files at regular intervals.  The data base is indexed on five
  1271.         separate fields for rapid retrieval of information.  If an error
  1272.         which causes the index files to mis-match the data files occurs,
  1273.         re-indexing of the appropriate index file will be necessary.
  1274.  
  1275.         The menu selection for reorganizing the data file will allow for
  1276.         re-indexing all index files or only selected files.
  1277.  
  1278.  
  1279.                   Sequential File Processing:
  1280.  
  1281.         Sequential files may be created from the three main data files.
  1282.         These files may be used by other programs if desired or may be
  1283.         read into a word processor.  They are plain ASCII files with
  1284.         fields separated by a comma and each entry is terminated with a
  1285.         carriage return and line feed.
  1286.  
  1287.         The structure is as follows:
  1288.  
  1289.             Breed.DA1     Main data in the following order:
  1290.             Entry status = 0 if valid entry, any other number if invalid.
  1291.             Name - maximum of 35 characters.
  1292.             A.K.C. registration number.
  1293.             Sex - B D or space.
  1294.             Birth date - yyyymmdd.
  1295.             Sire - line number of sire entry in file or 0 if unknown.
  1296.             Dam - line number of dam entry in file or 0 if unknown.
  1297.             Date Published in Stud Book - packed form.
  1298.             Championship Published - packed form.
  1299.             Companion Dog Published - packed form.
  1300.             Companion Dog Excellent Published - packed form.
  1301.             Utility Dog Published - packed form.
  1302.             Tracking Dog Published - packed form.
  1303.             Tracking Dog Excellent Published - packed form.
  1304.             Obedience Trial Championship Published - packed form.
  1305.             Amateur Field Trial Championship Published - packed form.
  1306.             Field Trial Championship Published - packed form.
  1307.             Junior Hunter Published - packed form.
  1308.             Senior Hunter Published - packed form.
  1309.             Master Hunter Published - packed form.
  1310.             Register of Merit Published - packed form.
  1311.             Certificate of Gameness Published - packed form.
  1312.  
  1313.             Packed form for published dates may be expanded to valid
  1314.             dates as follows:
  1315.                   0 -- means that no published date exists in file.
  1316.  
  1317.  
  1318.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 19
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.                   1 -- means that published date is known to exist, but
  1325.                        the date is not known.
  1326.             other # -- add 188000 to the number.  the right 2 digits are
  1327.                        the month and the left 4 digits are the year.  If
  1328.                        the month is 00 then the year is known but the
  1329.                        month is not.
  1330.  
  1331.  
  1332.             Breed.DA2     Alias names in the following order:
  1333.             Entry status = 0 if valid entry, any other number if invalid.
  1334.             Alias name of animal - 35 characters maximum.
  1335.             Actual name of animal in Breed.DA1.
  1336.  
  1337.             Breed.DA3     Foreign Champions in the following order:
  1338.             Entry status = 0 if valid entry, any other number if
  1339.             invalid.
  1340.             Line number of animal entry in Breed.DA1.
  1341.             Country of foreign championship.
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 20
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.                                 LICENSE AGREEMENT
  1394.  
  1395.  
  1396.                   Terms and conditions of use:
  1397.  
  1398.         All versions of PEDIGREE by Charles H. Orange are not public
  1399.         domain software, nor are they free software.
  1400.  
  1401.         Non-registered users are granted a limited license to use
  1402.         PEDIGREE on a trial basis only for the purpose of determining
  1403.         it's suitability for their needs.  Use of PEDIGREE except for
  1404.         this limited purpose requires registration.  Non-registered
  1405.         versions of PEDIGREE are limited to only 300 animal entries.
  1406.  
  1407.         Registration permits a user the license to use PEDIGREE on a
  1408.         single computer; a registered user may use the program on a
  1409.         different computer, but may not use the program on more than one
  1410.         computer at the same time.  Registered versions of PEDIGREE
  1411.         support over 2 million animal entries.
  1412.  
  1413.                   Terms and conditions of copying:
  1414.  
  1415.         All users are granted a limited license to copy the non-
  1416.         registered version of PEDIGREE for the purpose of archive or
  1417.         backup protection as well as for the trial use by others subject
  1418.         to the above limitations and to the following restrictions:
  1419.  
  1420.         Non-registered versions of PEDIGREE must be distributed in un-
  1421.         modified form, complete with the help and text files with this
  1422.         license information.
  1423.  
  1424.             No fee or charge may be made by anyone beyond the reasonable
  1425.             cost of duplication and media.
  1426.  
  1427.         Non-registered versions of PEDIGREE may be distributed in an
  1428.         archived format by operators of electronic bulletin boards if
  1429.         they observe the previous conditions.
  1430.  
  1431.         Registered versions of PEDIGREE may not be copied except for the
  1432.         purpose of archive or backup protection.
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.         PEDIGREE  (c) 1988-1989 Charles H. Orange                    Page: 21
  1451.  
  1452.  
  1453.